home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / sharexe.zip / SHAR.MAN < prev    next >
Text File  |  1988-02-21  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SHAR(1)             UNIX Programmer's Manual              SHAR(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      shar - create shell archive file for extraction by /bin/sh
  10.  
  11. SYNOPSIS
  12.      shar [ -b ] [ -nseq_number ] [ -eseq_end ] [ -ooutput_file ]
  13.      [ -tfinal_text ] files
  14.  
  15. DESCRIPTION
  16.      Shar takes a list of files, and generates a /bin/sh script
  17.      that, when executed, will re-create those files in a dif-
  18.      ferent directory or on a different machine.  The resultant
  19.      script will use wc(1) to do a mild error-check, and will
  20.      warn about possibly-omitted control characters.
  21.  
  22.      Shar generates scripts that will make directories and plain
  23.      files.  It will not try to generate intermediate filenames,
  24.      however, so
  25.           shar foo/bar/file
  26.      will not work.  Do
  27.           shar foo foo/bar foo/bar/file
  28.      instead.
  29.  
  30.      The script is normally sent to standard output; the ``-o''
  31.      option may be used to specify an output filename.  This is
  32.      designed to prevent filling up the disk if
  33.           shar * >SHAR
  34.      command is done; do
  35.           shar -o SHAR *
  36.      instead.
  37.  
  38.      The ``-b'' option says that all leading directory names
  39.      should be stripped from the file when they are packed into
  40.      the archive.  For example,
  41.           shar -b /etc/termcap
  42.      creates an archive that, when executed, creates a file named
  43.      ``termcap'' in the current directory, rather than overwrite
  44.      the host system file.  Note, however, that the scripts gen-
  45.      erated by shar refuse to overwrite pre-existing files; the
  46.      ``-b'' option is for convenience, and may not strictly be
  47.      necessary.
  48.  
  49.      Multi-part Archives
  50.      Most larger software packages are usually sent out in two or
  51.      more shell archives.  The ``-n,'' ``-e,'' and ``-t'' options
  52.      are used to make an archive that is part of a series.  The
  53.      individual archives are often called ``kits'' when this is
  54.      done.  The ``-n'' option specifies the archive number; the
  55.      ``-e'' option species the highest number in the series.
  56.      When executed, the generated archives will then echo mes-
  57.      sages like
  58.           shar: End of archive 3 of 9.
  59.      at their end.
  60.  
  61.  
  62.  
  63. Printed 2/21/88               LOCAL                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SHAR(1)             UNIX Programmer's Manual              SHAR(1)
  71.  
  72.  
  73.  
  74.      In addition, each shar will generate a file named
  75.      arkXisdone.  Each script will contain a loop to check for
  76.      the presence of these files, and indicate to the recipient
  77.      which archives still need to be executed.  The ``-t'' option
  78.      may be used to give starting instructions to the recipient.
  79.      When the scripts determine that all the archives have been
  80.      unpacked, the text specified with this flag is displayed.
  81.      For example,
  82.           shar -n1 -k9 -t "Now do 'sh ./Configure'" *.c >SHAR
  83.      Adds commands to output the following when all the archives
  84.      have been unpacked:
  85.           You have run archive 1.
  86.               .
  87.               .
  88.               .
  89.           You have run archive 9.
  90.           You have run all 9 archives.
  91.           Now do 'sh ./Configure'
  92.  
  93. SEE ALSO
  94.      echo(1), findsrc(1L), makekit(1L), mkdir(1), sh(1), test(1),
  95.      unshar(1L), wc(1).
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Printed 2/21/88               LOCAL                             2
  130.  
  131.  
  132.  
  133.